# Get grouped asset locations

Returns a grouped list of location instances associated with the specified furniture asset within the current account context.
            
Behavior:
- Validates asset association with the account
- Applies filtering criteria from the request body if provided
- Retrieves asset instance locations grouped by hierarchy or category
- Returns structured grouped location response data
- Logs the action as an asset instance location list view event

Endpoint: POST /api/v1/furniture/{assetIdentifier}/assetlocation/list

## Path parameters:

  - `assetIdentifier` (string, required)

## Request fields (application/json-patch+json):

  - `keyword` (string,null)

  - `sortColumn` (string,null)

  - `sortColumnId` (string,null)

  - `sortOrder` (string,null)

  - `fieldValues` (array,null)

  - `fieldValues.dataFieldId` (string)

  - `fieldValues.dataFieldValue` (string,null)

  - `fieldValues.dataFieldlabel` (string,null)

  - `fieldValues.dataFieldValueIds` (array,null)

  - `fieldValues.fromDate` (string,null)

  - `fieldValues.toDate` (string,null)

  - `fieldValues.dataFieldValueRangeType` (string,null)

  - `selectedIds` (array,null)

  - `datafieldIds` (array,null)

  - `filter` (string,null)

## Response 200 fields (text/plain):

  - `data` (object)

  - `data.generalProperties` (array,null)

  - `data.generalProperties.name` (string,null)

  - `data.generalProperties.alias` (string,null)

  - `data.generalProperties.dataType` (string,null)

  - `data.generalProperties.propertyType` (string,null)

  - `data.generalProperties.isKeyData` (boolean)

  - `data.generalProperties.visibility` (boolean)

  - `data.generalProperties.dataFieldId` (string)

  - `data.generalProperties.uiProperties` (object)

  - `data.generalProperties.uiProperties.fullWidth` (boolean)

  - `data.generalProperties.uiProperties.columnWidth` (string,null)

  - `data.generalProperties.uiProperties.columnSpan` (integer,null)

  - `data.data` (array,null)

  - `data.data.groupedAssetLocationId` (string)

  - `data.data.assetId` (string,null)

  - `data.data.asset` (string,null)

  - `data.data.assignedOn` (string,null)

  - `data.data.quantity` (integer)

  - `data.data.locationInfo` (object)

  - `data.data.locationInfo.location` (string,null)

  - `data.data.locationInfo.locationId` (string,null)

  - `data.data.locationInfo.building` (string,null)

  - `data.data.locationInfo.buildingId` (string,null)

  - `data.data.locationInfo.level` (string,null)

  - `data.data.locationInfo.levelId` (string,null)

  - `data.data.locationInfo.room` (string,null)

  - `data.data.locationInfo.roomId` (string,null)

  - `data.data.locationInfo.workspace` (string,null)

  - `data.data.locationInfo.workspaceId` (string,null)

  - `data.data.locationInfo.spaceKey` (string,null)

  - `data.data.locationInfo.spaceAssignedOn` (string,null)

  - `data.data.locationInfo.spaceCategory` (object)

  - `data.data.locationInfo.spaceCategory.spaceCategoryId` (string)

  - `data.data.locationInfo.spaceCategory.spaceCategoryName` (string,null)

  - `data.data.locationInfo.spaceCategory.spaceCategoryCode` (string,null)

  - `data.data.locationInfo.roomFunction` (object)

  - `data.data.locationInfo.roomFunction.roomFunctionId` (string)

  - `data.data.locationInfo.roomFunction.roomFunctionName` (string,null)

  - `data.data.locationInfo.spaceArea` (number,null)

  - `data.data.locationInfo.levelPlanHandle` (string,null)

  - `data.data.locationInfo.employeeLocationId` (string,null)

  - `data.data.locationInfo.rollBackInfo` (object)

  - `data.data.locationInfo.rollBackInfo.isRollBack` (boolean)

  - `data.data.locationInfo.rollBackInfo.rollBackType` (string,null)

  - `data.data.locationInfo.rollBackInfo.employeeLocationId` (string)

  - `data.data.locationInfo.rollBackInfo.comments` (string,null)

  - `data.data.locationInfo.levelPlanId` (string,null)

  - `data.data.locationInfo.planFile` (object)

  - `data.data.locationInfo.planFile.fileId` (string)

  - `data.data.locationInfo.planFile.fileName` (string,null)

  - `data.data.locationInfo.planFile.fileSize` (string,null)

  - `data.data.locationInfo.planFile.currentRevisionNumber` (integer)

  - `data.data.locationInfo.planFile.createdOn` (string,null)

  - `data.data.locationInfo.planFile.fileSizeInBytes` (integer)

  - `data.data.locationInfo.planFile.createdDate` (string)

  - `data.data.locationInfo.planFile.createdBy` (string,null)

  - `data.data.locationInfo.planFile.isLatest` (boolean)

  - `data.data.locationInfo.cadPlanCoordinates` (array,null)

  - `data.data.locationInfo.spaceAssignedOnDateTimeFormat` (string,null)

  - `data.data.locationInfo.svgPlanAdded` (boolean)

  - `data.listProperties` (object)

  - `data.listProperties.totalCount` (integer)

  - `data.listProperties.currentStart` (integer)

  - `data.listProperties.currentLength` (integer)

  - `data.listProperties.pageCount` (integer)

  - `message` (string,null)

  - `isError` (boolean)

  - `messageCode` (integer)

  - `status` (string,null)

  - `errorType` (string,null)

  - `traceid` (string,null)

  - `responseDescription` (string,null)